Public Home page + per-spec "plans → achievements" step (flagged)#18
Merged
Conversation
|
Adds the demonstrator's public-facing welcome page and turns the comms plan's stage-gate progress cadence into a per-spec "plans -> achievements" discipline, recorded register-first as a flagged candidate. docs/assay-home.html — hand-authored Home/Overview (comms plan §4 page 1; projects concept §1). Self-contained and static (comms plan §6.4): inline CSS/SVG, no external assets, theme-aware (light/dark). Reuses the demonstrator's own band-pill / four-stop verdict colour language (ui-design §2, comms plan §8) so the site looks like the honesty it reports. Sections: objectives + premise, the spine diagram (Knowledge -> Compile -> Score -> Analyse -> Surfaces, status-coloured), links to the published surfaces (gallery/, wireframes.html), theses A-H with honest state chips, a progress/achievements tracker (Stage 0/1 done, Stage 2 in progress), a clearly-labelled forthcoming-articles section (no dead link), the banded-honesty stance, and the canonical-doc index. Honesty guardrails hold: nothing shown as done the repository does not contain; the fictional Meridian framing is stated on every relevant block. Deployment note: the publish pipeline (PR #17, scripts/build-site.ts) copies this file to the site root as index.html; its relative app links resolve once deployed. Left unwired here to avoid conflicting with that in-flight work. Process change (register-first, ASSAY-DEC-2): - concept §6.12 — flagged candidate: each build spec carries a home-page- currency step in its definition of "done" when it moves a thesis/stage from planned to demonstrated. Not yet ratified. - comms plan §9 + .specify/templates/tasks-template.md — the step wired in provisionally, marked pending ratification (the DEC-16 / sparse-channel "build against the flagged candidate" pattern). npm test: 89 passing; typecheck clean. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011vg1J8cqoCaAdUD1qMMnWS
PR #17's publish pipeline is on main, so the deferred wiring is unblocked. build-site.ts now copies the hand-authored Home page (docs/assay-home.html) to site/index.html instead of generating a minimal inline landing, so the demonstrator's front door is the reviewed, on-brand page rather than a stub. Honest preview labelling is preserved: a <!--BUILD_BADGE--> placeholder in the Home page is replaced with a "preview of PR #N · <sha>" badge only when PR_NUMBER is set. Production (main) and local builds ship badge-free — a preview must announce itself; the real site needs no label. Verified: npm run build:site writes the Home page as root (gallery/ and wireframes.html alongside); preview build injects the badge + commit link; production build is clean. typecheck clean; committed gallery output byte-identical (regeneration is a no-op). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011vg1J8cqoCaAdUD1qMMnWS
5c85c65 to
6b39f57
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds the demonstrator's public-facing Home / Overview page (the "welcome page"), wires it as the published site root, and turns the comms plan's stage-gate progress cadence into a per-spec "plans → achievements" discipline — recorded register-first as a flagged candidate.
The welcome page —
docs/assay-home.htmlHand-authored Home page (comms plan §4, page 1; projects concept §1). Modern and graphical, self-contained and static (comms plan §6.4): inline CSS + inline SVG, no external fonts/scripts/CDNs, theme-aware (light + dark). It reuses the demonstrator's own band-pill / four-stop verdict colour language (ui-design §2, comms plan §8) so the site looks like the honesty it reports.
Sections:
gallery/) and the role-surface wireframes (wireframes.html).Honesty guardrails hold: nothing is shown as done that the repository does not contain.
Blog link
There are no blog posts in the repo or on
gh-pagesyet, so the "articles" card is a labelled forthcoming section tied to the roadmap rather than a dead link.Publish wiring —
scripts/build-site.tsPR #17 merged to
mainduring this work, so the previously-deferred integration is now included.build-site.tscopiesdocs/assay-home.htmltosite/index.html(replacing its minimal inline landing), so the demonstrator's front door is this reviewed page. Honest preview labelling is preserved: a<!--BUILD_BADGE-->placeholder is replaced with apreview of PR #N · <sha>badge only on PR-preview builds; production (main) and local builds ship badge-free — a preview must announce itself, the real site needs no label. The page's relative links (gallery/,wireframes.html) resolve to the surfaces the same build copies alongside it.Process change — register-first (ASSAY-DEC-2)
Modifying the planning process is a decision, so it enters as a flagged candidate, not asserted into peer docs:
concept.md §6.12— flagged candidate: each build spec carries a home-page-currency step in its definition of "done" when it moves a thesis or stage from planned to demonstrated. Not yet ratified.comms-plan.md §9+.specify/templates/tasks-template.md— the step wired in provisionally, marked pending ratification, mirroring the DEC-16-floor / sparse-channel "build against the flagged candidate under delegated authority" pattern.On ratification this batch-propagates to the delivery plan §1.
Verification
npm test— 89 passing;npm run typecheckclean.npm run build:site: production writes the Home page as root (gallery/ + wireframes.html alongside); preview build injects the badge + commit link; committed gallery output byte-identical (regeneration is a no-op).stageclass collided with the tracker's.stage { display: grid }rule and rendered full-width — resolved by renaming the hero modifier classes.)🤖 Generated with Claude Code